Trac is being migrated to new services! Issues can be found in our new YouTrack instance and WIKI pages can be found on our website.

Changes between Version 122 and Version 123 of Using Pidgin


Ignore:
Timestamp:
Aug 18, 2008, 10:43:40 PM (15 years ago)
Author:
chemistrydioxide
Comment:

moved platform-independent question "What should I do if Pidgin crashes?" from Windows to all platforms section

Legend:

Unmodified
Added
Removed
Modified
  • Using Pidgin

    v122 v123  
    226226
    227227=== Pidgin Crashing ===
     228= ["Using Pidgin"] =
     229
     230[[TOC(inline,noheading)]]
     231
     232== All Platforms ==
     233
     234=== Getting Started ===
     235
     236==== How do I use AIM, MSN, Yahoo!, Google Talk/Jabber/XMPP, ICQ, or any other protocol? ====
     237Use the Account Editor (Accounts->Add/Edit) to add the account of the appropriate messaging service.  Use the checkbox in the account editor to enable the current account.
     238
     239For Google Talk, fill in the Domain field with the domain of your Google Mail e-mail address.  For most users this will be gmail.com or googlemail.com, but Google Apps for Your Domain users will use their domain instead.
     240
     241==== How do I register for a new account? ====
     242This depends on the protocol.
     243 * '''AIM:''' Go to [https://reg.my.screenname.aol.com/_cqr/registration/initRegistration.psp?mcState=initialized&seamless=n&createSn=1&sitedomain=www.aim.com&siteState=http://www.aim.com/get_aim/congratsd2.adp this website].
     244 * '''MSN (including Hotmail email):'''Go to http://registernet.passport.com/
     245 * '''MSN (using your own email address):''' Go to http://register.passport.net/
     246 * '''Yahoo:''' Go to http://edit.yahoo.com/config/eval_register
     247 * '''XMPP (Jabber):''' This will depend on the server in question.  All Jabber servers use the XMPP account type.  Go to http://www.jabber.org/user/quickstart.shtml for some public Jabber servers or visit [https://www.google.com/accounts/NewAccount?service=talk Google Talk's account creation page]
     248 * '''ICQ:''' Go to http://web.icq.com/register
     249 * '''Gadu-Gadu:''' In the ''Add Account'' dialog select Gadu-Gadu protocol and click the ''Register'' button.
     250 * '''Novell:''' See your Novell server administrator.
     251
     252=== Buddy Icons (Avatars), Buddy List and Blocking ===
     253
     254==== How do I set a buddy icon or avatar? ====
     255We call all user pictures, avatars, etc. buddy icons.  There are two ways to set one for yourself:
     256  * '''Global''' - This will affect all of your accounts.  On the Buddy List window, beside the status selector at the bottom, there is an area that will have a generic photo icon if you have no icon set.  You can click that and select an icon from there.  The icon will take effect for all accounts you have configured in Pidgin.
     257  * '''Per-account''' - This will affect only the account you modify.  Go to Accounts->''your account''->Edit Account.  On that dialog, check the box labeled "Use this buddy icon for this account:", then click the leftmost button below that checkbox.  Select your buddy icon.
     258
     259In either case, the file must be smaller than 4KB to work on AIM and XMPP.  It can have any dimensions, and can be in any format.  However, if you wish Windows users to see it, it must be in a format Windows understands, such as .bmp, .gif, and .jpg.  Pidgin will attempt to scale icons to fit within these constraints, but it is not always possible to do so.
     260
     261The following dimension guidelines are believed to be accurate as of June 2007:
     262||'''Protocol'''||'''Dimensions'''||'''Format'''||'''File Size'''||
     263||AIM||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)||
     264||ICQ||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)||
     265||Yahoo!||96x96||png, gif, jpg||||
     266||XMPP (including Google Talk)||32x32 to 96x96||png, gif, jpeg||8191 bytes (one byte short of 8.0KB)||
     267||MSN||up to 96x96||png||||
     268
     269Pidgin itself (for the chat window) will scale icons up or down to 32x32 for display in the buddy list and the infopane.  In general, to maintain the aspect ratio, you should begin with a square icon.
     270
     271==== A friend of mine uses my favorite episode of ''The Young and the Restless'' as her buddy icon, but I can't quite make it out in the infopane.  What do I do? ====
     272
     273The easiest thing to do is ask your friend to put it up on !YouTube or some equivalent service.  Alternatively, you could buy it on DVD, if available.  The mouse-over tooltip on the infopane also has her full-size buddy icon, for a quick fix.  Additionally, clicking the icon in the infopane should also enlarge it.
     274
     275==== How can I unblock someone? ====
     276See the "Privacy" option under the "Tools" menu in the Buddy List.
     277
     278==== Why are the status icons so big? ====
     279==== Can I make buddy list entries smaller? ====
     280We believe that, by adding a second line of text to each buddy list entry, we're able to show more information about each buddy on the buddy list.  The "Big List," as we call it, shows status text and idle time concisely and attractively.  Most importantly, it puts the buddy icon in the list, making it far easier to locate buddies within a large list where names are harder to pick out than images.  Due to the increased usability of this interface, we have made it the default.
     281
     282We are aware that some people feel more comfortable using an interface more similar to IM clients they may have used in the past.  The 'Big List' can  be disabled by un-checking "Show buddy details" in the Buddies menu.
     283
     284==== Can I import or export my buddy list? ====
     285Not with Pidgin alone, but the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] provides the [http://plugins.guifications.org/trac/wiki/listhandler List Handler] plugin, which adds some importing and exporting capabilities.
     286
     287==== Why are my logs combining the logs of several of my buddies? ====
     288It's likely you have inadvertently combined some buddies into contacts when you did not intend to do so.  To correct this you need to find which contact the logs are associated with.  Right-click that entry in the buddy list and click Expand.  Drag out the buddies that do not belong in the contact.
     289
     290==== Where did my buddy go?  I just tried to change its group and it disappeared! ====
     291You inadvertently created a contact from two buddies.  Hover over each buddy in the destination group and watch the tooltips that appear.  You'll see the "missing" buddy in one of them.  Right-click that entry in the buddy list, click Expand, and then drag the buddy that does not belong out to the group.  Watch the buddy list carefully; a bar will appear to show you where the buddy will go if you are in the right location.
     292
     293==== Can I group buddies by their owner, like Trillian's or Miranda's Metacontacts? ====
     294Sure! Right click a buddy on your list and at the bottom of the menu click "Expand".  Then just drag other screen names to the same person below it.  When you're done, click on the arrow to collapse them.  When the contact is collapsed, Pidgin will select a buddy to display based on the status of the buddies in the contact, and their order.
     295
     296If you use the Alias function, by either highlighting a buddy and pressing F2 or right-clicking and selecting "Alias...," when two or more buddies in the same group are aliased to the same name, Pidgin will prompt you to automatically merge them together into one contact.
     297
     298==== I grouped my buddies into contacts, can I control which one is selected? ====
     299Yes and no.  Pidgin uses an algorithm to determine which buddy is selected.  If you right click on a contact
     300and select expand, you can see an ordered list of the buddies in that contact.  Pidgin will pick the                                                                                                                                                 highest/topmost buddy that is most available.
     301                                                                                                                                                                                                                 
     302It computes which is most available as follows:
     303  1. It will start at the top looking for a buddy that is "present" and not idle. If it finds one, it will use that.
     304  1. If it did not already find one, it will then start at the top looking for a buddy that is away but not idle. If it finds one, it will use that.
     305  1. If it has not already found one, it will start at the top of the list looking for a buddy that is idle but not away.  If it finds one, it will use that.
     306  1. If it has not already found one, it will start at the top of the list looking for a buddy that is both away and idle.  If it finds one it will use that.
     307  1. Lastly, if all of the buddies are offline, it will pick the top buddy. Ideally it would search the list one more time, looking for a buddy that is offline, but on a protocol that supports offline messages.  This has not, however, been implemented yet.
     308
     309With this search pattern, you should be able to drag the buddies in that contact into an order that will yield reasonable results for that contact most of the time.  While this will be sufficient for most people most of the time, we recognize that a small minority of users may need to control things more precisely.  In the source tarball there is a plugin, contact_priority, that does not install by default.  If installed and loaded, this plugin allows for some modifications to the algorithm that Pidgin uses.  Specifically, you can weight certain accounts to be either more likely to be chosen or less likely to be chosen. This cannot, however, be done on a per-buddy basis with the existing plugin.
     310
     311==== Why are protocol icons not displayed in the buddy list and conversation windows any more? ====
     312See [http://pidgin.im/~seanegan/blog/identity.html Sean's blog entry on the subject] for the rationale behind this change.  However, as of Pidgin 2.2.0 you can add protocol icons to the buddy list with Buddies-> Show->Protocol Icons.  The [http://plugins.guifications.org/trac/wiki/convbadger convbadger plugin] from the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] adds protocol icons to conversation windows.
     313
     314=== Keyboard Shortcuts ===
     315
     316==== What are the default keyboard shortcuts (key bindings)? ====
     317See [wiki:shortcuts this wiki page] for a list.
     318
     319==== How do I make Enter make a newline and Ctrl+Enter send? ====
     320
     321Locate or create your `gtkrc-2.0` file and insert:
     322{{{
     323binding "my-bindings"
     324{
     325    bind "Return" { "insert-at-cursor" ("\n") }
     326    bind "<ctrl>Return" { "message_send" () }
     327}
     328widget "*pidgin_conv_entry" binding "my-bindings"
     329}}}
     330
     331==== How do I make Pidgin use emacs-like keybindings? ====
     332Locate or create your `.gtkrc-2.0` file and insert the following:
     333{{{
     334gtk-key-theme-name = "Emacs"
     335}}}
     336You will need to restart Pidgin when you have finished.  Note that this will affect other GTK+ applications as well.
     337
     338==== How do I bind keystrokes to menu items? ====
     339
     340Locate or create your `gtkrc-2.0` file and insert:
     341
     342{{{
     343gtk-can-change-accels = 1
     344}}}
     345
     346After coercing Pidgin into rereading this file (for instance, by restarting it), you can hover over a menu item and hit the keystroke you want to bind to it, and your wish will be granted!  (You might want to turn off `gtk-can-change-accels` again when you're done, since it's pretty easy to bind keys by mistake with it turned on.)
     347
     348If you're using a recent enough Gnome, you can instead open the ''Appearance'' preferences applet, switch to the ''Interface'' tab and toggle ''Editable menu shortcut keys''.  In older versions of Gnome, use `gconf-editor` to set the `/desktop/gnome/interface/can_change_accels` key instead (which is what happens in newer Gnomes behind the scenes anyway).  You don't need to restart Pidgin if you take the gconf path.
     349
     350==== How do I make Escape close conversation windows? ====
     351As of 2.4.2 this option is included by default. The option is under Tools ⇒ Preferences ⇒ Interface Tab.
     352
     353=== Spell Checking ===
     354
     355==== How do I change the language for the Highlight Misspelled words option? ====
     356Pidgin currently only supports spell checking in your locale language.  This is because gtkspell 2 does not offer a good way for us to know which dictionaries are available or to switch between them.  This functionality has long been promised for gtkspell version 3, which has been delayed somewhat indefinitely.  See [http://gtkspell.sf.net gtkspell.sf.net].
     357
     358There is, however a simple plugin called [http://plugins.guifications.org/trac/wiki/switchspell switchspell] that can change the spell check language on a per-buddy basis.
     359
     360==== Why do all words I type get highlighted as misspelled? ====
     361We've seen several users with this issue.  It seems to be that the dictionary for the spell checking language is missing.  Most likely you need to install a package named "`aspell-XX`" where `XX` is the language you run Pidgin in, such as `en` for English or `es` for Spanish.
     362
     363=== Statuses ===
     364
     365==== How does Pidgin decide which saved statuses to show in the status selector? ====
     366Pidgin shows six "popular" saved statuses in the status selector. These are your six most recently used statuses, offset by a weight. Pidgin sorts all your saved statuses by the timestamp when they were last used.  And then, for each time you've used a status, the timestamp is increased by one day.
     367
     368If you are upgrading from 1.x or lower, Pidgin is unable to determine which are the most popular states, as these older releases did not save that information.  As a result, the initial contents of the menu will be somewhat random.  It will settle over the first few uses of (distinct) states into the behavior described above.
     369
     370==== Why are no states listed when I go to set a state for Auto Away? ====
     371Pidgin can only use saved states for Auto Away.  You need to create and save a named state first.
     372
     373=== Smileys (Emoticons) ===
     374
     375==== Does Pidgin support animated smileys? ====
     376Yes, but there is a bug which can cause animation to be lost if Pidgin has to resize the image.  Also, only the most recent 20 emoticons are animated.
     377
     378==== How do I use/make smiley themes? ====
     379See [wiki:SmileyThemes the page on smileys].
     380
     381=== Look & Feel ===
     382
     383==== Can I "skin" Pidgin? ====
     384The UI can be customized using GTK themes and by [wiki:SmileyThemes Smiley Themes].  Application-specific skins will never be supported by Pidgin.  This seems to confuse a lot of users, so here's an attempt at an explanation.
     385
     386Themes allow you to change font size, font face, the color of different elements of the UI, and sometimes their shape. All of this is perfectly reasonable, and encompasses the range of configuration that ''most'' users are requesting. Skins go beyond this. Skins allow you to move and possibly suppress different elements of the UI that the programmers have added for specific reasons.
     387
     388In so doing, skins create a support nightmare. The developer, talking to the user, cannot be sure that the user sees the same interface. Is it a bug that the user cannot see how to change font size, or is the user's skin suppressing that widget? This is an unacceptable situation.
     389
     390Conversely, while themes allow some silliness, for instance setting the background to the same color as the font, the results are relatively easily foreseen and avoided by theme authors. Further, by using the existing GTK theme mechanism, we gain two advantages:
     391  1. We don't have to write it ourselves.  Were we to write our own mechanism, we would be adding overhead in both the run time and the time necessary to debug.
     392  1. We have a built in way of debugging theme problems, by checking if the same bug exists with other GTK programs.
     393
     394Lastly, since GTK themes only allow acceptable modifications, we do not have to worry that a user isn't seeing part of the UI because it is either showing or not showing ''because of our code''.
     395
     396Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
     397
     398The default location on Windows to add the theme is: `C:\Program Files\Common Files\GTK\2.0\share\themes` (TODO: This isn't correct, it should be the user-specific directory, not the global directory).
     399
     400==== How do I change the font Pidgin uses?  The background color? ====
     401The font preference in Pidgin applies only for the formatting of outgoing messages on those protocols which support said formatting.  The display fonts used by the rest of Pidgin are those specified by GTK+, the toolkit we use to create the user interface.  If you're using Gnome, you can change these in System ⇒ Preferences ⇒ Appearance ⇒ Fonts; the font used for conversations is the ''document'' font, while the rest of Pidgin uses the ''application'' font.
     402
     403If you're not running Gnome and want to change the fonts used, you need to edit your `~/.gtkrc-2.0` (or `~/.purple/gtkrc-2.0`) file.  On Windows, see [wiki:"Using Pidgin#WhatisagtkrcfileandwherecanIfindit" this FAQ entry] for the location of the gtkrc file.  If that file does not exist, simply create it.
     404
     405As an example, you can put this into `.gtkrc-2.0` to change the font size for all GTK+ applications:
     406{{{
     407# Sets the font used by all gtk applications.
     408gtk-font-name = "Verdana 9"
     409}}}
     410
     411Alternatively, you can do this to change the font size for other elements:
     412{{{
     413# This is the style section.  You need this for the examples below.
     414# If you are going to copy the example, copy the entire block,
     415# including the "{" and "}" lines.
     416style "imhtml-fix"
     417{
     418    font_name = "Sans 10"
     419}
     420
     421# This will apply the font style just shown to various components.
     422# If you are going to copy the example, copy the line that does
     423# what you want.
     424
     425# Conversation entry box--where you type.
     426widget "*pidgin_conv_entry" style "imhtml-fix"
     427
     428# Conversation history pane--where you read the conversation.
     429widget "*pidgin_conv_imhtml" style "imhtml-fix"
     430
     431# Log viewer--where you read stored logs
     432widget "*pidgin_log_imhtml" style "imhtml-fix"
     433
     434# formatting-capable entry areas (IMHtml widgets) in request dialogs
     435widget "*pidgin_request_imhtml" style "imhtml-fix"
     436
     437# formatting-capable notification areas in dialogs (again, IMHtml widgets)
     438widget "*pidgin_notify_imhtml" style "imhtml-fix"
     439}}}
     440
     441Background colors can be changed similarly, by finding the correct widget names and setting appropriate bg elements.  Other widgets in Pidgin can be controlled in a similar manner.  For example, to change the background color for a group, do something similar to the following:
     442
     443{{{
     444style "NoPidginGroupColor"
     445{
     446    bg[ACTIVE]   = "#FFFFFF"
     447}
     448
     449widget "*pidgin_blist_treeview" style "NoPidginGroupColor"
     450}}}
     451
     452You could also switch GTK+ themes.  Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
     453
     454=== Crashes and Bugs ===
     455
     456==== What should I do if Pidgin crashes? ====
     457Follow the instructions [wiki:TipsForBugReports#WhattodoifPidgincrashes here] to submit a bug report.
    228458
    229459==== Why does Pidgin crash when I start it? ====
     
    316546== Windows Specific ==
    317547
    318 === Proxy and Connection Settings and Problems ===
     548=== Proxies and Connection Settings and Problems ===
    319549
    320550==== Why can't I connect? My firewall is configured to allow Pidgin access. ==== #windowsfirewall
     
    337567Yes, if you set the proxy preference to "Use Environmental Settings", Pidgin will parse the HTTP Proxy setting from Windows as long as you have a specific server set; auto-detection and configuration via `.pac` URL do not work, nor do proxy bypass settings.
    338568
    339 === Running Windows Pidgin From a USB Drive (Portable Mode) ===
     569=== Portable Mode ===
     570
     571==== Running Windows Pidgin From a USB Drive (Portable Mode) ====
    340572It is relatively easy to set up Pidgin to run from a USB drive. Most of Pidgin is very good about not assuming that it is installed; a slightly customized launcher makes it all come together nicely.
    341573
     
    421653If you just want the buddy list to always be on top, you can dock it to the side of your desktop.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can set any window to be 'Always On Top'.
    422654
    423 === Pidgin Crashing ===
    424 
    425 ==== What should I do if Pidgin crashes? ====
    426 Follow the instructions [wiki:TipsForBugReports#WhattodoifPidgincrashes here] to submit a bug report.
    427 
    428655=== Miscellaneous ===
    429656
     
    494721Ubuntu Gutsy shipped a broken `/etc/purple/prefs.xml` for a while which caused this problem.  See [https://bugs.launchpad.net/ubuntu/+source/pidgin/+bug/144122 this bug report] for information on the problem and how to fix it.
    495722
     723
     724==== Why does Pidgin crash when I start it? ====
     725Here are some things to try:
     726  * Make sure you are running the most recent version of Pidgin.
     727  * Make sure only one version of Pidgin is installed.  On UNIX-like systems, `whereis pidgin` can be helpful for this.
     728  * Make sure Pidgin is not already running.  In recent versions, if an instance of Pidgin is already running then a new instance will not start without specifically forcing it.  You can check the process list on your operating system or look for the "System Tray" or "Notification Area" icon.
     729  * If you are running a UNIX-like system, try "export GDK_USE_XFT=0" in a terminal, then run Pidgin from the same terminal.
     730  * Disable or remove any third-party plugins, especially those related to encryption.
     731  * If disabling third-party plugins doesn't help, disable ''all'' plugins.
     732  * If you are on Windows, deleting `tcl.dll` from the Pidgin install directory may prove helpful.
     733  * If none of these help, read TipsForBugReports.
     734
     735==== Pidgin <non-current-version> is buggy.  Why? ====
     736==== Pidgin from Monotone is buggy.  Why? ====
     737Non-current versions have old bugs which may be fixed in the current version--that's why we make new releases.  Monotone is frequently unusable because of changes in the code.  Bugs are introduced during the development process and are hopefully fixed before a release is made.
     738
     739=== Voice and Video (Microphone and Webcam) Support (Not Implemented Yet) ===
     740
     741==== Does Pidgin support webcams (video)? ====
     742==== Does Pidgin support MSN video chat? ====
     743Not currently.  It is planned.  See below.
     744
     745==== Does Pidgin support microphones (voice)? ====
     746==== Does Pidgin support libjingle? ====
     747Not currently.  It is planned.  See below.
     748
     749==== When will voice and video be implemented? ====
     750We plan to implement these features eventually, but it is a daunting task.  Not all of our developers care about these features, and because of that don't want to work on them.  The time available to those developers who do want to work on these features is limited, and so any work on these features proceeds slowly.
     751
     752We aim to have an abstracted, protocol-agnostic API for voice and video, which makes the task harder.  Also adding to the difficulty is that now that we have a completely split core (libpurple) and UI (Pidgin and Finch), we refuse to take a step backward and violate this split.  The protocol plugins can NOT have any code in them that is UI-dependent, or we break the libpurple/UI split.  This imposes additional restrictions that make it a very painstaking process to implement voice and video correctly.
     753
     754In short, we have no idea when this will happen.  It could be tomorrow, or it could be in 2099.  That's really the best answer we can give right now.
     755
     756Some history and current status on voice and video should be collected at the ProgressReport page.
     757
     758=== Miscellaneous ===
     759
     760==== Can I change the height of the text input area? ====
     761You can't manually resize the text input area, nor disable auto-resizing. The area auto-resizes up to a height of half the window height before the scrollbar appears.
     762
     763==== When will newer MSN features be supported? ====
     764
     765Support for MSN protocol version has been merged and will be available with the Pidgin 2.5.0 release (tentative). Currently only old MSN protocol version support is enabled by default.
     766
     767See more information about support for the newer features on the ProgressReport page.
     768
     769==== How can I enter non-ASCII characters? (like Windows' Alt+###) ==== #win32-alt-codes
     770Entering character codes works differently in GTK+; press `Ctrl+Shift+u` and then type the Unicode number (in hexadecimal) with Ctrl and Shift held down. GTK+ 2.10.0 and later versions do not require Ctrl and Shift to be held down while typing the number.  For example, `Alt-164` would become `Ctrl+Shift+u`, `f1`.
     771
     772==== Can I still see messages in a chat if I close the window? ====
     773Yes.  Pidgin has a persistent chat feature, where you will remain in a chat room even if you close the window.  When you open the window again, all the messages that were sent are still there as if the window had been open the whole time. 
     774
     775To make a chat persistent, add it to your buddy list, then right click and choose "Persistent" from the context menu.
     776
     777==== What happened to my timestamps?  Can I change them? ====
     778As of 2.0.0, timestamps follow the system locale.  This is a significant difference from previous versions of Pidgin, and though it was requested more than once, we know it will prove to be a controversial decision.  Fortunately for all of you out there, we also provide plugins to change it.
     779
     780The two plugins we provide are the Timestamp plugin and the Message Timestamp Formats plugin.  Timestamp allows you to have iChat style timestamps, but it is implemented to behave slightly differently.  The Message Timestamp Formats plugin allows you to manipulate the timestamps in a couple different ways, such as restoring 24-hour timestamps and/or causing all timestamps to have dates in them.
     781
     782==== What is a "Buddy Pounce"? ====
     783Pidgin introduced buddy pounces a few releases before AOL came out with "Buddy Alerts."  Despite this, you could think of a buddy pounce as an alert and get an idea of the most minimal use of a buddy pounce.  In reality, a buddy pounce is much like a macro, or a recorded action.  When you set a pounce on someone, you can choose from a number of events, such as sign on or status change, and then you choose from a number of actions.  These actions include everything from playing a sound (like an alert would do) to sending a message to the person, to executing a command.  This action will occur the next time pidgin detects the event, i.e. the next time the person in your buddy list who you have pounced signs on.
     784
     785==== Can I use Pidgin for e-mail, blogging, RSS feeds, or anything else that isn't IM-related? ====
     786No, you can't.  We get requests for this often, but Pidgin is indeed a messaging client.  Aside from the capabilities each protocol may support, the Pidgin developers have no intention to turn Pidgin into a multi-feature Internet client capable of doing everything under the sun.  We also won't be helping to develop plugins to turn it into that.  There are many Internet applications available for Linux, Windows, or whatever operating system you use that would undoubtedly do a better job.
     787
     788Note that [http://www.livejournal.com LiveJournal] provides an XMPP messaging service which makes it possible to make entries to your blog via IM, no matter what XMPP-supporting IM client you use.
     789
     790==== Pidgin beeps whenever I press backspace, how do I disable that? ====
     791
     792See http://developer.pidgin.im/ticket/3683 .
     793
     794==== Can I turn the tray icon off? ====
     795Yes.  By default the tray icon will load if you have a Notification Area or a System Tray in your desktop environment.  Look at the Interface tab in Tools->Preferences.  Change the 'System Tray Icon' setting to 'Always', 'Never', or 'On unread messages' as you prefer.
     796
     797==== What do those colors in the conversation tab mean? ====
     798 * '''Red''' - A message is waiting for you in a chat that does not contain your name
     799 * '''Blue''' - Someone (in one-on-one IM) sent you a message or (in chats) said your name/nickname
     800 * '''Green''' - The buddy is typing
     801 * '''Yellow''' - The buddy began typing, and then stopped
     802 * '''Gray''' - There has been a join or a part in that chat, or the buddy has signed off
     803
     804==== I get "accept/reject certificate" prompts all the time. What do I do? ====
     805This may mean that the Pidgin root certificate set is incomplete. If so, we'd like to hear about it. Do the following:
     806 1. Accept the Certificate
     807 2. Go to Tools->Certificates
     808 3. Select the relevant server and export the certificate to a file.
     809 4. [/simpleticket File a ticket]. Attach the exported certificate, and specify which protocol you are connecting to, as well as the server the certificate is for.
     810
     811== Windows Specific ==
     812
     813=== Proxy and Connection Settings and Problems ===
     814
     815==== Why can't I connect? My firewall is configured to allow Pidgin access. ==== #windowsfirewall
     816We've had a lot of problems with various firewalls, particularly Norton Internet Security (and Symantec Client Firewall).  Many firewalls will not fully stop interfering with a program's ability to connect when configured to do so.
     817
     818For Norton Internet Security, a workaround that seems to work is to add the following ports to the global `HTTP Ports` list:
     819 * 443 -> MSN (ssl)
     820 * 1863 -> MSN
     821 * 5050 -> Yahoo
     822 * 5190 -> AIM/ICQ
     823 * 5222 -> XMPP (including Google Talk)
     824 * 6667 -> IRC
     825
     826The Mozilla folks maintain a good Windows Firewall information resource [http://kb.mozillazine.org/Firewalls here].
     827
     828==== What does "Windows socket error !#10060" mean, and how do I fix it? ====
     829This is a horribly obtuse error message which simply means that Pidgin was unable to connect to some remote host, probably the IM server you were trying to use.  This is almost never a problem with Pidgin or its configuration; generally it indicates a network problem, firewall problem, or NAT/router problem.  If you are running a Windows firewall product, check [#windowsfirewall the appropriate FAQ question] for possible solutions.
     830
     831==== Can Pidgin use my Windows (IE) Proxy Settings? ====
     832Yes, if you set the proxy preference to "Use Environmental Settings", Pidgin will parse the HTTP Proxy setting from Windows as long as you have a specific server set; auto-detection and configuration via `.pac` URL do not work, nor do proxy bypass settings.
     833
     834=== Running Windows Pidgin From a USB Drive (Portable Mode) ===
     835It is relatively easy to set up Pidgin to run from a USB drive. Most of Pidgin is very good about not assuming that it is installed; a slightly customized launcher makes it all come together nicely.
     836
     837'''N.B.:''' With the setup described in this guide, other GTK+ applications can use the same GTK+ runtime.
     838
     839'''''Preparation'''''
     840 * create a temporary folder structure (e.g. in `C:\tmp`):
     841   * `extracted`
     842   * `extracted\GTK`
     843   * `extracted\Pidgin`
     844   * `portable`
     845   * `portable\GTK`
     846   * `portable\Pidgin`
     847 * '''download''' the zipped binaries of [http://sourceforge.net/project/showfiles.php?group_id=235&package_id=230234 Pidgin] (`pidgin-`<''version''>`-win32-bin.zip`) and [http://sourceforge.net/project/showfiles.php?group_id=235&package_id=119698 GTK+] (`gtk-`<''version''>`-rev-a-installer.tar.gz`) from SourceForge
     848 * '''extract''' these archives to `extracted\GTK` and `extracted\Pidgin`, respectively
     849
     850'''''Pidgin'''''
     851 * copy (or move) everything ''except'' the following folders from `extracted\Pidgin` to `portable\Pidgin`:
     852   * `ca-certs`
     853   * `perlmod`
     854 * delete (or rename) `perl.dll` and `tcl.dll` in `portable\Pidgin\plugins`
     855 * '''language'''
     856   * if you do ''not'' want to use a language other than American English (`en_US`), delete the entire `portable\Pidgin\locale` folder
     857   * otherwise, delete all ''except'' the desired languages' folders (e.g. `en_GB` or `fr`) from `portable\Pidgin\locale`
     858 * '''spell-checking'''
     859   * if you do ''not'' want to use spell-checking, delete `libgtkspell.dll` from `portable\Pidgin`
     860   * otherwise, see '''ASpell''' instructions below
     861 * rename `portable\Pidgin\pidgin.exe` to `portable\Pidgin\pidgin-portable.exe` - this will cause Pidgin to run in "portable mode"
     862
     863'''''GTK+'''''
     864 * copy (or move) everything ''except'' the following files and folders to `portable\GTK`:
     865   * `extracted\GTK\share`
     866   * `extracted\GTK\COPYING.LIB-2`
     867 * '''language'''
     868   * if you want to use a language other than American English (`en_US`), copy the appropriate `extracted\GTK\share\locale\<`''language''`>` folders to `portable\GTK\share\locale`.
     869 * '''theme'''
     870   * choose any GTK+ theme from `share\themes` (usually `MS-Windows`)
     871   * copy the theme's `gtkrc` file from `extracted\GTK\share\themes\`<''theme''>`\gtk-2.0` to `portable\GTK\etc\gtk-2.0`, replacing the existing file
     872
     873'''''ASpell'''''
     874
     875For spell-checking support, you will also need to create a minimal ASpell runtime installation from an existing ASpell installation.
     876  * create a folder `portable\Aspell` and a sub-folder `portable\Aspell\bin`
     877  * copy `aspell-15.dll` into `portable\Aspell\bin`
     878  * copy the `data` and `dict` sub-folders into `Portable\Aspell`
     879
     880Now you can move the entire `portable` onto your USB drive (e.g. `U:\`).
     881Running `U:\portable\Pidgin\pidgin-portable.exe` will cause Pidgin to run off the USB drive, saving all settings, logs etc. to `U:\portable\.purple`.
     882
     883'''''Upgrading Pidgin Portable'''''
     884
     885In order to upgrade Pidgin portable to a new version, simply download the latest [http://sourceforge.net/project/showfiles.php?group_id=235&package_id=230234 zipped binaries] and follow the steps described in the '''Pidgin''' section above.
     886
     887=== Smileys (Emoticons) ===
     888
     889==== Why did my smiley theme disappear after I upgraded Pidgin? ====
     890Smiley themes should be installed to the user's .purple directory, not in the location Pidgin is installed to.  This means that you install smiley themes only to `%APPDATA%\.purple\smileys`.  Additions to or removals from Pidgin's installation location will be lost during an upgrade.
     891
     892=== Look & Feel ===
     893
     894==== How do I change the look and feel? ====
     895See [#CanIskinPidgin this FAQ entry].
     896
     897==== What is a gtkrc file and where can I find it? ====
     898The windowing toolkit that Pidgin uses, GTK+, is configurable via a text file.
     899
     900There is a global file found in the `etc\gtk-2.0` directory your GTK+ Runtime install directory (`C:\Program Files\Common Files\GTK\2.0`, by default).
     901There is also per-user file (named `.gtkrc-2.0`) in your user's home directory, the location of this varies according to the version of Windows you're using and the configuration.
     902 * For Windows 2000/XP/Vista(?), entering `%USERPROFILE%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username`).
     903 * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`.
     904 * If you have the `HOME` environment variable set, it will override the default per-user file location.
     905
     906**Note that Windows Explorer will not allow you create a file that starts with a period; you'll need to use a text editor or rename the file in a cmd shell.
     907
     908There is also a pidgin-specific file that is located in the configuration directory (`%APPDATA%\.purple\gtkrc-2.0`).
     909
     910It is recommended that you edit your per-user file or the pidgin-specific file instead of the global file as the global file will be replaced when GTK+ is upgraded.
     911
     912==== Can I make Pidgin transparent/translucent? ====
     913You can make Pidgin translucent in most versions of Windows using the "Transparency" plugin that ships with Pidgin for Windows.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can to make any window translucent.
     914
     915==== Can I make Pidgin or its instant message windows always stay on top? ====
     916If you just want the buddy list to always be on top, you can dock it to the side of your desktop.  A user has also recommended the freeware Windows utility, [http://www.abstractpath.com/powermenu/ PowerMenu] which can set any window to be 'Always On Top'.
     917
     918=== Miscellaneous ===
     919
     920==== How does Pidgin for Windows determine which language to use? ====
     921For the user who installed Pidgin, the language selected during installation will be the default.
     922This can be overridden by setting the `PIDGINLANG` environment variable (for example, `PIDGINLANG=de`).
     923If neither of these are specified, it will fall back to the default Windows user locale setting.
     924
     925==== Where are my settings and data (including logs) saved? ====
     926==== Where is my `.purple` directory? ====
     927Data is stored in your user's "Application Data" directory in a `.purple` subdirectory.  The location of this will vary according to your setup and version of Windows.
     928 * For Windows 2000/XP/Vista(?), entering `%APPDATA%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username\Application Data`).
     929 * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`.
     930This can be overridden by setting the `PURPLEHOME` environment variable.
     931
     932Logs are stored in a subdirectory called `logs`.
     933
     934==== How do I run multiple instances of Pidgin on Windows? ====
     935Pidgin will, by default, prevent multiple instances from running simultaneously.
     936You can override this restriction by defining the `PIDGIN_MULTI_INST` environment variable or by specifying the `-m` command line parameter.
     937If you do this, you may find the `-c` parameter useful to specify unique configuration directories for each instance (e.g. `-c c:\home\.pidgin-alt`).
     938
     939==== Can I use Pidgin for Bonjour (Link-Local Messaging)? ====
     940As of version 2.0.2, Pidgin for Windows supports Bonjour.  You must install Apple's [http://www.apple.com/support/downloads/bonjourforwindows.html Bonjour for Windows] to use this functionality.
     941
     942==== Can I run Pidgin on Windows98/ME? ====
     943Yes, but you need to use an old GTK+ runtime (2.6.10 or older); you can download the [http://downloads.sourceforge.net/pidgin/gtk-runtime-2.6.10-rev-a.exe standalone GTK+ 2.6.10 runtime installer] and install it separately before installing Pidgin.  These old GTK+ versions are unmaintained and will have bugs that won't be fixed.
     944
     945== Linux and Unix-like platforms ==
     946
     947=== Sound ===
     948
     949==== How do I get sound to work correctly? ====
     950Pidgin uses gstreamer to play sounds.  Playing sounds directly through esound or arts is no longer supported.  To compile Pidgin with support for gstreamer you need libgstreamer0.10-dev and its dependencies.  These packages are named differently on different platforms.  If you do not wish to install these packages you can also just change your sound playing method in preferences to `Command` and use `esdplay %s`, `artsplay %s`, `aplay %s`, or `play %s`.
     951
     952==== How do I make Pidgin use ALSA or OSS for playing sounds? ====
     953==== What does the "Automatic" option do? ====
     954The "Automatic" option lets gstreamer pick how the sounds are played.  You can use the `gstreamer-properties` tool to control this if you use GNOME.
     955
     956=== Look & Feel ===
     957
     958==== How do I change the look and feel? ====
     959See [#CanIskinPidgin this FAQ entry].
     960
     961Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google.
     962
     963The system-wide location on Windows to add themes is `C:\Program Files\Common Files\GTK\2.0\share\themes`, but this location will be overwritten when installing updated GTK+ runtime versions.
     964
     965==== Can I make Pidgin transparent/translucent? ====
     966It is not yet possible to make Pidgin translucent in Linux and other platforms that use X11.
     967
     968The X.org X11 server provides a COMPOSITE extension that allows applications to have true translucency, but it is X.org-specific and it requires support at the GTK+ level (if it is to be per-widget).  Support for this is apparently scheduled for inclusion GDK 2.12, but we are not currently interested in implementing support for it (note that a plugin could provide this functionality).  Pseudo-translucency offered by other programs (by copying a section of your background image, tinting it, and plastering it onto a window) will never be implemented in Pidgin.
     969
     970Note that if you are using a compisiting window manager such as Compiz, you may have global support for modifying the opacity of any window.  For example, in Compiz, the default method to changing the opacity of a window is Alt+Mouse Scroll Wheel.  This method does not require extra support from the applications.
     971
     972=== Miscellaneous ===
     973
     974==== Where are Pidgin's settings and logs? ====
     975Because Pidgin is a libpurple client, it stores its settings and logs in ~/.purple.
     976
     977==== Why does Pidgin use the same `WM_CLASS` for every window? ====
     978Both strings in the `WM_CLASS` property are supposed to be the same for all windows in the same instance of an application.  ICCCM states that one is meant to be the same for all instances of the application and the other is meant to be unique to that instance of the application.  ICCCM also states, "If a client has multiple windows with identical `WM_CLASS` and `WM_NAME` properties, then it should provide a `WM_WINDOW_ROLE` property."
     979
     980GTK+ sets these `WM_CLASS` values for us so that they are unique for Pidgin instances, and the documentation for the `gtk_window_set_wmclass` function says explicitly not to use it for anything else.  Pidgin uses the `WM_WINDOW_ROLE` hint to differentiate windows.  If your window manager is having problems differentiating between Pidgin windows, please ensure it uses the `WM_WINDOW_ROLE` hint per the ICCCM.
     981
     982==== Pidgin doesn't remember which plugins I have enabled between restarts ====
     983
     984Ubuntu Gutsy shipped a broken `/etc/purple/prefs.xml` for a while which caused this problem.  See [https://bugs.launchpad.net/ubuntu/+source/pidgin/+bug/144122 this bug report] for information on the problem and how to fix it.
     985
All information, including names and email addresses, entered onto this website or sent to mailing lists affiliated with this website will be public. Do not post confidential information, especially passwords!